home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / comm / tlx_sq15.zip / TLX_SQR.DOC < prev    next >
Text File  |  1991-02-08  |  44KB  |  910 lines
  1.            TELIX-SQUARE package by Inge Vabekk (soft-ACE).
  2.  
  3.      NB.! NB.! NB.! NB.! NB.! NB.! NB.! NB.! NB.! NB.! NB.! NB.!
  4.    ╔═════════════════════════════════════════════════════════════╗
  5.    ║                      THIS IS VERSION 1.5.                   ║
  6.    ║ I will appreciate your feedback,  whether you are satisfied ║ 
  7.    ║ or not!  Messages can  be sent  to me  via private  mail at ║
  8.    ║ Oslo Hard Disco,  tel. (472) 73 12 47,  in MIX/Hjelp, or at ║
  9.    ║ Thunderball Cave, tel.(472) 56 70 17/18, in the XBoard con- ║
  10.    ║ ference. I occasionally also call other systems, but if you ║
  11.    ║ live far from Oslo,  you can call another  MBBS system with ║
  12.    ║ MIX connection to Oslo Hard Disco, or a PCBoard system with ║
  13.    ║ PCrelay connection. Route the mail to ->CAVE.               ║
  14.    ╟─────────────────────────────────────────────────────────────╢
  15.    ║ The scripts for MBBS and PCBoard have been tested and found ║
  16.    ║ to work satisfactory. The RBBS script is supplied, but is   ║
  17.    ║ not completed. If you use RBBS and you can do some improve- ║
  18.    ║ ments on the scripts, please do so. However I will appreci- ║
  19.    ║ ate to be informed, so that I can make the improvements     ║
  20.    ║ available to other users as well.                           ║
  21.    ╚═════════════════════════════════════════════════════════════╝
  22.      NB.! NB.! NB.! NB.! NB.! NB.! NB.! NB.! NB.! NB.! NB.! NB.!
  23.  
  24.    ╔═════════════════════════════════════════════════════════════╗
  25.    ║    VERSION UPDATES:  Please read the file TLX_SQR.NEW.      ║
  26.    ╚═════════════════════════════════════════════════════════════╝
  27.  
  28.  
  29.               ┌─────────────────────────────────────────╖
  30.               │  G E N E R A L   D E S C R I P T I O N  ║
  31.               ╘═════════════════════════════════════════╝
  32.  
  33.   The following  describes a set of  utility programs and scripts for
  34.   use with the communication program TELIX. This set contains several
  35.   SALT scripts  (SALT is the  programming language for TELIX),  batch
  36.   files, and programs, all written in C.
  37.  
  38.   All SALT scripts are supplied with source code.
  39.  
  40.   The TELIX program itself,  and the compile program CS.EXE,  are the
  41.   obvious prerequisites to use this utility.  You should use the 3.12
  42.   version until rev 4.0 comes out.  The CS compiler  is supplied with
  43.   TELIX.
  44.   A little warning: If you're not familiar with SALT, HAVE THE MANUAL
  45.   AT HAND, AND USE IT!
  46.  
  47.  
  48.               ┌─────────────────────────────────────────╖
  49.               │             F E A T U R E S             ║
  50.               ╘═════════════════════════════════════════╝
  51.  
  52.   The Telix_Square package gives you the following advantages:
  53.  
  54.   * Easy logging in to any MBBS,  RBBS or  PCBoard system. Later ver-
  55.     sions are planned to include other systems as well.
  56.     Note that the scripts only work with systems that can use English
  57.     commands, and have prompts in English. Some Sysops choose to only
  58.     use the native language. This will NOT work except for MBBS which
  59.     allows the sript to change the language after logging in. For PCB
  60.     systems, if there is no choice of language, the LOGON script will
  61.     fail.
  62.   * You can call  several BBSes without user intervention,  according
  63.     to a BBS call list.
  64.   * Continued execution of aborted call lists.
  65.   * Timed execution start.  You may specify a start time for starting
  66.     the calls,  after which all the  BBSes in your list are called in
  67.     the normal sequence.
  68.   * Automatic upload and download of messages.
  69.   * Support of several offline mail readers and doors: MegaMail, Mark
  70.     Mail, PCBoard, ProDoor (ZIPM) and XBoard (for MBBS and PCBoard).
  71.   * Automatic upload and download of files.
  72.   * Automatic updating of the BBS file lists.
  73.   * Separate directories for download of mail packets and normal file
  74.     download (if wanted).
  75.   * Ability to save global parameters in memory,  so that each script
  76.     can find them without  disc access.  Some scripts  are started by
  77.     pressing a softkey (f-key). Since all necessary parameters are in
  78.     a global area, no extra initialization is necessary.
  79.   * Automatic selection  of files for  upload and download.  Your own
  80.     directories, as well as the BBS file lists, are being checked be-
  81.     for you're online, to minimize you phone bills.
  82.   * While on-line, the BBS name is displayed in the status bar.
  83.   * Automatic logoff from the BBS you're calling  (can be switched on
  84.     and off - current setting is displayed in the status line)
  85.   * Automatic exit from Telix  when all BBSes  in your list have been
  86.     called (can be switched on and off - current setting is displayed
  87.     in the status line)
  88.   * Choice of using DSZ for uploads and downloads.
  89.   * Supports voice calls.
  90.   * Easy, straightforward installation.
  91.  
  92.  
  93.               ┌─────────────────────────────────────────╖
  94.               │         H O W   T O   S T A R T         ║
  95.               ╘═════════════════════════════════════════╝
  96.  
  97.   Installing the software is easy. Since you're reading this note you
  98.   have already unpacked the TLX_SQ*.ZIP file, so you're half through.
  99.   But before you proceed,  make sure that all default directories are
  100.   defined  in the Telix  configuration  (menu entered  with  ALT-O in
  101.   TELIX).  Your editor of choice  (for ASCII editing)  should also be
  102.   defined there.
  103.  
  104.   Execute the TINST.EXE program using the command
  105.  
  106.   TINST <Telix directory>.
  107.  
  108.   <Telix directory>  is the directory  which contains  the  TELIX.CNF
  109.   configuration file.  The installation procedure  reads vital infor-
  110.   mation from that file and will not be able to complete without it.
  111.  
  112.   After some files have been copied to your Telix directories and the
  113.   scripts have been compiled,  your favourite editor  is scheduled to
  114.   edit your  NAME.DAT file.  The parameters required  should be quite
  115.   obvious, but if in doubt, read the NAME.DAT description below.
  116.  
  117.   The install program  should now work with DOS revisions before 3.3,
  118.   since it has been converted to a program.  However,  I haven't been
  119.   able to try, so if it doesn't, please give me a note.
  120.  
  121.   The files copied to the Telix main directory are as follows:
  122.  
  123.   NAME.DAT     -Contains your name, address, default password etc.
  124.  
  125.   WISH.LST     -Here's where you list files that you want to download
  126.                 from the BBSes you call. This file is updated automa-
  127.                 tically each time you run the Telix_Square system.
  128.                 For the format of this file, check the description of
  129.                 DNLOAD.SLT.
  130.  
  131.   PUSH.LST     -Here's where you enter the names of files you want to
  132.                 upload to BBSes.  For the format of this file,  check
  133.                 the description of UPLOAD.SLT. Also check out program
  134.                 PPUSH,  which helps you to build a PUSH.LST file from
  135.                 a BBS list file.
  136.  
  137.   All Telix_Square files are described below. Check that you have all
  138.   of them. Mark an entry in your phone directory with the script name
  139.   LOGON, exit from Telix again, and call that BBS by typing
  140.   
  141.   c:\> fone <BBS name>
  142.   
  143.   If it calls the BBS and logs in without problems, you're well under
  144.   way. You can now mark other entries with LOGON as well. However, if
  145.   you know that the system is *not* MBBS, PCBoard or RBBS, you should
  146.   log in manually or use other scripts.  If you have the LOG file on,
  147.   please send me a copy of you login sequence,  and I'll see if I can
  148.   include support for that system.
  149.  
  150.  
  151. NOTE:
  152.   The file FONE.BAT is a sample command file to start Telix using the
  153.   Telix_Square scripts.  This file must also be modified to suit your
  154.   own needs. Also, move it to the directory where you keep your other
  155.   .BAT files (should be in your path).
  156.  
  157.   If you're using 4DOS  from J.P Software,  FONE.BAT should work fine
  158.   without any additional software. If you're using the standard shell
  159.   COMMAND.COM, you also need the programs  PUSHDIR and POPDIR,  which 
  160.   are PC Magazine programs that can be found on nearly any BBS. Since
  161.   the programs are quite small, I have taken the liberty to add  them
  162.   to the TLX_SQ